home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 034a / swop145g.zip / SWOP.DOC next >
Text File  |  1991-12-20  |  16KB  |  345 lines
  1.  
  2.                 ╔════╗
  3.                 ║    ╩
  4.                 ║
  5.                 ╚════╗  ╦     ╦ ╔════╗ ╔════╗
  6.                      ║  ║  ╦  ║ ║    ║ ║    ║
  7.                 ╦    ║  ║  ║  ║ ║    ║ ║    ║
  8.                 ╚════╝  ╚══╩══╝ ╚════╝ ╠════╝       Version 1.05
  9.                                        ║
  10.                                        ║
  11.                                        ╩
  12.  
  13.  
  14.                               CopyRighted 1991 by
  15.  
  16.                            PC-2-PC COMMUNICATIONS CC
  17.  
  18.  
  19.  
  20. ══════════════════════════════════════════════════════════════════════════════
  21.  
  22.                  A door for a PCBoard Version 14.5 BBS software.
  23.  
  24.           This door allows a SYSOP to provide his users with a facility
  25.                 to SWOP their time available for more bytes,  or,
  26.                    to swop their bytes available for more time.
  27.  
  28. ══════════════════════════════════════════════════════════════════════════════
  29.  
  30.               PC-2-PC COMMUNICATIONS is situated in South Africa.
  31.  
  32.               BBS tel. no's :  Node 1 - (011) 391-3627  (2400 bps)
  33.                                Node 2 - (011) 391-3628  (2400 bps)
  34.  
  35.  
  36.  
  37. ╔═══════╗
  38. ║ INDEX ║
  39. ╚═══════╝
  40.  
  41.  
  42.              Opening words............................... 1
  43.              System requirements......................... 1
  44.              Installation................................ 2
  45.              Syntax and parameters for SWOP.EXE.......... 4
  46.              Features.................................... 5
  47.              A special word about Base Baud Rate......... 6
  48.              What if you do not registered as a user..... 6
  49.              List of files with descriptions............. 6
  50.              History of the program releases............. 7
  51.  
  52.  
  53. ╔═══════════════╗                                                PAGE 1
  54. ║ OPENING WORDS ║
  55. ╚═══════════════╝
  56.  
  57.     This software,  along with its documentation is CopyRight by
  58.     PC-2-PC COMMUNICATION CC.  You may not alter anything inside the
  59.     program,  and/or the documentation.
  60.  
  61.     This software is being distributed under the Public Domain concept.
  62.     This means that you as the user are allowed to use the program for
  63.     as long as you like.   We do not force you to register the software,
  64.     however,  if you find that you like the program, you are encouraged
  65.     to register yourself as a user with a R40.00 contribution.
  66.  
  67.     Registered users do not get any special previledges above those not
  68.     registered,  nor do they get some better changed release of this
  69.     software if they did register.  But take note that we written this
  70.     software for those guys that use it,  and contribute if they like
  71.     what they see,  even though they aint forced to do so.
  72.  
  73.  
  74. ╔═════════════════════╗
  75. ║ SYSTEM REQUIREMENTS ║
  76. ╚═════════════════════╝
  77.     Hardware  :  IBM Compatible,  modem,  hard-drive,  ect.
  78.     Software  :  PCBoard Version 14.5  BBS software
  79.     Memory    :  The available RAM required to run this door
  80.                  when out of PCBoard is 100 kB.
  81.  
  82.     Networks  :  On a network,  ensure that file-server has some
  83.                  sub-directory,  accessible to all nodes.  This is
  84.                  where the security-access "SWOPPWRD" file would
  85.                  be referenced to as a parameter.
  86.  
  87.     Other     :  A VERY HARD WORKING SYSOP!!!!!
  88.  
  89. ╔══════════════╗                                                 PAGE 2
  90. ║ INSTALLATION ║
  91. ╚══════════════╝
  92.  
  93.     This section is placed so early in the documentation so that you
  94.     do not have to read about an half an hour,  before you find the
  95.     installation part.
  96.  
  97.     First we have to mention the following:
  98.       If you really hate reading documents,  you could always just
  99.       run the program direct from the DOS prompt,  and it would lead
  100.       you to install it correctly.
  101.  
  102.     Now,  here is a proper description of how to install this door.
  103.     No fancy stuff required with the SWOP door.
  104.  
  105.       Just follow the following steps one by one:
  106.  
  107.     1.   Ensure that you have somewhere in your Path statement located
  108.          usually in the AUTOEXEC.BAT file, a path stating the location
  109.          of your PCBOARD sub-directory,   or just simply make sure you
  110.          do change the directory in the file SWOP(created by yourself)
  111.          to the PCBOARD sub-directory,  before calling SWOP.EXE.
  112.  
  113.     2.   Now go to your PCBoard sub-directory,  and run PCBSETUP.
  114.  
  115.     3.   Select either      J  Main Board Configuration
  116.                                         or
  117.                             K  Conferences.
  118.  
  119.          Conferences in the case if you plan to install SWOP door
  120.          inside a specific conference only.
  121.  
  122.     4.   Select now under Doors: "Path/Name List File" and select
  123.          your DOORS.LST file with 'F2'.
  124.  
  125.     5.   Go to the last entry and enter 'Alt-I' to add this door,
  126.          and enter stuff as follow:
  127.  
  128.    Filename   Password   Sec Login USER.SYS DOOR.SYS Path to Batch Files
  129.   ══════════ ═══════════ ═══ ═════ ════════ ════════ ════════════════════
  130.  1) SWOP                  0    N       Y        N    <path for SWOP>
  131.  
  132.          Save it now.  (Take note of Y under USERS.SYS)
  133.  
  134.     6.   Select now under Doors: "Menu Listing" your DOORS menu file
  135.          and add the SWOP door listing in your menu.
  136.                                                                 PAGE 3
  137.     7.   Now create the SWOP file at the location you specified in
  138.          step (5) five.    Not SWOP.BAT,  as PCBoard expects you to
  139.          have the batch file commands in a file for himself,  without
  140.          the "BAT" extension.
  141.          PCBoard will create its own DOOR.BAT file,  to eliminate
  142.          a possibility of share violations if you had a Network
  143.          installed.
  144.  
  145.          Inside the SWOP file enter the following commands
  146.  
  147.             ECHO OFF
  148.             CD <location of SWOP.EXE ex: C:\PCB\DOORS>
  149.             SWOP <location of "SWOPPWRD"  ex: Z:\DOORS\SWOPPWRD>
  150.             CD <back to PCBoard sub-directory>
  151.             BOARD
  152.  
  153.  
  154.     That's it folks,  the minimum requirements is above to get your door
  155.     up and running.
  156.  
  157.     Here is what our SWOP file looks like on our BBS:
  158.                   @ECHO OFF
  159.                   CD\PCB\DOORS\SWOP
  160.                   SWOP Z:\PCB\DOORS\SWOPPWRD
  161.                   CD\PCB
  162.                   BOARD
  163.  
  164. ╔════════════════════════════════════╗                           PAGE 4
  165. ║ SYNTAX AND PARAMETERS FOR SWOP.EXE ║
  166. ╚════════════════════════════════════╝
  167.  
  168. Syntax:  SWOP <full path for SWOPPWRD>
  169.  
  170.  <Full path for SWOPPWRD> : This means that we want you to specify the
  171.                             exact path and name of the SWOPPWRD file.
  172.                                (SWOPPWRD gets created by the door)
  173.                             This is very important if operating in
  174.                             a networking environment.
  175.  
  176.                      Parameters is not case sensitive.
  177.  
  178.       REMEMBER: Set the USER.SYS flag inside DOOR.LST to yes!!!!!
  179.  
  180.  
  181. ╔══════════╗                                                     PAGE 5
  182. ║ FEATURES ║
  183. ╚══════════╝
  184.  
  185.     1.   Support from Com1 up to Com8.
  186.     2.   Support from 300 baud up to 115,000 Baud.
  187.     3.   ANSI Emulation,  without the need of ANSI.SYS in CONFIG.SYS
  188.     4.   Auto detection of the com port in use,  and baud rate.
  189.     5.   Detection of Data Carrier Detect.  The door will recycle back
  190.          to PCBoard,  in the case of a Carrier Lost,  while in the door.
  191.     6.   Auto adapt to the bell flag the SYSOP has setted, to
  192.          ensure that if the flag was set to off,  the door do not
  193.          send bell sounds to the local speaker.
  194.     7.   Auto detection of keyboard time-out period as setted inside
  195.          PCBoard.  Your user will be exited back to PCBoard if he
  196.          does not press a key within your specified time limit.
  197.     8.   Filtering of characters.  This ensures that most line noise
  198.          usually over the line is filtered out.
  199.     9.   Multiple commands accepted if entered at command line,  just
  200.          the same as with PCBoard.
  201.    10.   Allow the user to change between Graphics and normal mode.
  202.    11.   Give help information to users that need it.
  203.    12.   Allow the user to re-display the screen,  if the screen was
  204.          garbled.
  205.    13.   Will not allow a user with unlimited bytes facility to trade
  206.          bytes or time.  A user with unlimited bytes would otherwise
  207.          have been able to have unlimited time as well.
  208.    14.   Will not give access to a user,  if the SYSOP has setted the
  209.          bytes/minute to 0 bytes.  An way to stop certain users to use
  210.          the facility if the SYSOP wishes to do so.
  211.    15.   Allow the user to trade time in for more bytes to download.
  212.    16.   Allow the user to trade bytes in for more time on the system.
  213.    17.   Allow the SYSOP to set a bytes/minute,  min time left,  and
  214.          a base baud rate for every security level individually.
  215.          All this from the local console,  without the need to drop to
  216.          DOS,  to run a special utility.
  217.    18.   Ability to let the bytes/minute change according to the users
  218.          connect speed.
  219.          (Bytes/Minute = Bytes/minute * Base Baud rate / Connect speed.)
  220.  
  221. ╔═════════════════════════════════════╗                           PAGE 6
  222. ║ A SPECIAL WORD ABOUT BASE BAUD RATE ║
  223. ╚═════════════════════════════════════╝
  224.   The base baud rate give you the facility to let the bytes per minute
  225.   change according to the connect speed of your user.  (This is one of
  226.   the configuration facilities as in item 18 on previous page)
  227.  
  228. { Bytes per minute = Bytes per minute * (Base Baud Rate / connect speed) }
  229.  
  230.    Assume the following setting were inside the SWOPPWRD file.
  231.        Bytes per minute = 10000,       Base Baud Rate = 2400
  232.  
  233.  
  234.  Connect speed |           Calculation of new Bytes per minute
  235.  ==============|===========================================================
  236.     300 baud   | Bytes per min = 10000 * (2400 / 300)    =    80000
  237.    1200 baud   | Bytes per min = 10000 * (2400 / 1200)   =    20000
  238.    2400 baud   | Bytes per min = 10000 * (2400 / 2400)   =    10000
  239.    9600 baud   | Bytes per min = 10000 * (2400 / 9600)   =     2500
  240.   19200 baud   | Bytes per min = 10000 * (2400 / 19200)  =     1250
  241.  
  242.   The higher the connect speed,  the lower the bytes per minute.
  243.   Only here encase some of wanted it.   However,  if you think
  244.   carefully about it.  A user could fool you easily in such a case
  245.   by connecting at 300 baud.  Swop 10 minutes to receive 800,000 bytes.
  246.   Log-off,  call in at 19200 baud,  and download the 800,000 bytes
  247.   within a few minutes.  It is therefor not recommended to use the
  248.   Base Baud Rate facility.  Like I said,  only here encase some of
  249.   you insist on it.
  250.  
  251.  
  252. ╔═════════════════════════════════════════════╗
  253. ║ WHAT IF THE YOU DO NOT REGISTERED AS A USER ║
  254. ╚═════════════════════════════════════════════╝
  255.  
  256.     Then nothing.  If you do not register as a user,  all we can say
  257.     is,  good luck,  and we hope you like the door.   Many people can
  258.     not because their budget is not so great.  Others can not because
  259.     they don't have the time to get to the post office.
  260.  
  261.     So if you do not register,  don't worry.  Your copy will still work
  262.     100%,  their is absolute no crippeling in this door.
  263.  
  264. ╔════════════════════════════════╗
  265. ║ LIST OF FILES AND DESCRIPTIONS ║
  266. ╚════════════════════════════════╝
  267.  
  268.     Only two files were issued along with SWOP145G.ZIP
  269.  
  270.     SWOP.DOC - You are reading it right now.
  271.     SWOP.EXE - The actual door program.
  272.  
  273.  
  274. ╔═════════╗                                                      PAGE 7
  275. ║ HISTORY ║
  276. ╚═════════╝
  277.     01 December 1991  :  "SWOP145A.ZIP"
  278.                          Initial release of the SWOP door.
  279.  
  280.     06 December 1991  :  "SWOP145B.ZIP"  -  Version 1.0
  281.                          Same as for 01 December 1991,  but is called
  282.                          Version 1.0.   With this version we removed
  283.                          all crippling that was in previous release.
  284.  
  285.     10 December 1991  :  "SWOP145C.ZIP"  -  Version 1.01
  286.                          Program was unable to detect that it is the
  287.                          SYSOP on-line,  if the SYSOP has entered his
  288.                          name in PCBSETUP with non-capital letters.
  289.                          This meant that in this case,  the sysop
  290.                          would not be able to change the security
  291.                          configuration from the local console as he
  292.                          is suppose to do.
  293.                          Fixed this by making the program not to be
  294.                          case sensitive when checking for the SYSOP's
  295.                          name.    ooops...
  296.  
  297.     12 December 1991  :  "SWOP145D.ZIP"  -  Version 1.02
  298.                          Somewhere we did something wrong in vers. 1.01
  299.                          The program was suddenly unable to transmit
  300.                          characters over the comms port.
  301.                                    Sorry....    fixed now.
  302.  
  303.     16 December 1991  :  "SWOP145E.ZIP"  -  Version 1.03
  304.                          Still the same old problem that the program is
  305.                          unable to transmit characters over the comms
  306.                          port.  This was because we tried to get clever
  307.                          with software flow-control (XON/XOFF),  and
  308.                          hardware flow-control (CTS/RTS).  We now removed
  309.                          the ability to adapt to the hardware/software
  310.                          flow control.  We now take the comm port as left
  311.                          by PCBoard,  and return it back the way we
  312.                          received it.  Seems like this solved our
  313.                          problem.  Let us know if anyone with an
  314.                          error-correcting modem experience some
  315.                          problems,  although we expect to hear every
  316.                          one is happy with it,  the way it is now.
  317.  
  318.     19 December 1991  :  "SWOP145F.ZIP"  -  Version 1.04
  319.                          The door had a problem that it gets an runtime
  320.                          error,  as soon as it was installed for the first
  321.                          time.  It was because we attempted to delete a
  322.                          file,  that was still open.   This is now fixed,
  323.                          thanks to the thorough investigation of Joaqium
  324.                          Inacio from VC BBS at (011) 435-3922.  Thank
  325.                          you for your patience George.
  326.  
  327.     20 December 1991  :  "SWOP145G.ZIP"  -  Version 1.05
  328.                         1. Removed the [NOT REGISTERED] handicap if not
  329.                            registered.  We now no longer force you to
  330.                            register.  We now ask you politely to register
  331.                            "yourself" as a user,  and not to register
  332.                            the "program".   So,  as from this release the
  333.                            program will allways be as if it is registered
  334.                            allready.
  335.                         2. All previous programs,  registered or not, would
  336.                            only be able to opperate under PCBoard 14.5.
  337.                            As from this release,  it is programmed to
  338.                            allready accept the new formats of PCBoard
  339.                            vers 15.0 and higher.
  340.                         3. Also we done some "fine-tuning",   that resulted
  341.                            into the fact that the program code was decreased
  342.                            with at least 3400 bytes.
  343.  
  344. - THE END -
  345.